package com.gengzp.system.mapper;

import com.gengzp.common.model.role.entity.SysRole;
import com.gengzp.common.model.role.req.PageSysRoleReq;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.Collection;
import java.util.List;

/**
 * @ClassName SysRoleMapper
 * @Description 系统角色管理模块mapper层接口
 * @Author gengzp
 * @Date 2025/9/8 19:54
 */
@Mapper
public interface SysRoleMapper {

    /**
     * 插入一条系统角色
     *
     * @param sysRole 系统角色
     */
    void insertSysRole(SysRole sysRole);

    /**
     * 根据id编辑系统角色
     *
     * @param sysRole 系统角色
     */
    void updateSysRoleById(SysRole sysRole);

    /**
     * 根据id逻辑删除系统角色
     *
     * @param sysRole 系统角色
     */
    void deleteSysRoleById(SysRole sysRole);

    /**
     * 根据名称查询系统角色
     *
     * @param roleName 角色名称
     * @return 系统角色
     */
    SysRole selectSysRoleByName(@Param("roleName") String roleName);

    /**
     * 根据id查询系统角色
     *
     * @param id 角色id
     * @return 系统角色
     */
    SysRole selectSysRoleById(@Param("id") Long id);

    /**
     * 根据id集合查询系统角色
     *
     * @param ids id集合
     * @return 系统角色集合
     */
    List<SysRole> selectSysRolesByIds(@Param("ids") Collection<Long> ids);

    /**
     * 查询所有系统角色
     *
     * @return 系统角色集合
     */
    List<SysRole> selectAllSysRoles();

    /**
     * 分页查询系统角色
     *
     * @param req 分页查询系统角色请求实体
     * @return 系统角色集合
     */
    List<SysRole> pageQuerySysRole(PageSysRoleReq req);

}
